home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 September / macformat-004.iso / Shareware in MacFormat / PwrSwitcher 1.1.3 / PwrSwitcher-FAQ < prev    next >
Encoding:
Text File  |  1994-06-04  |  13.2 KB  |  263 lines  |  [TEXT/EMAC]
  1. PwrSwitcher FAQ
  2. David B. Lamkins (DBLamkins@aol.com)
  3. Version 1.5
  4.  
  5. Created 1994 Jan  4 - 1.0
  6. Revised 1994 Jan 21 - 1.1
  7. Revised 1994 Feb 14 - 1.2
  8. Revised 1994 Mar 29 - 1.3
  9. Revised 1994 Apr 25 - 1.4
  10. Revised 1994 Jun  4 - 1.5
  11.  
  12. As of January 1994, I have stopped supporting PwrSwitcher. This
  13. document, which answers frequently asked questions regarding
  14. PwrSwitcher, is the only response now available to inquiries.
  15.  
  16. Q: What is the most recent release of PwrSwitcher?
  17. A: The final release is 1.1.3 - there will be no more.  I know I said
  18.    this in January with 1.1.2, but unique circumstances enticed me to
  19.    bring the code out of retirement for a couple of hours.
  20.  
  21. Q: Why did you release 1.1.3 after you said 1.1.2 was the final
  22.    version?
  23. A: Mark Nagata and Kevin Hardman worked together to isolate and
  24.    diagnose a crash caused by PwrSwitcher when used with Symbionts'
  25.    "pause on caps-lock" feature.  It turns out that any keyboard
  26.    activity would cause PwrSwitcher to crash, if that activity
  27.    occurred after PwrSwitcher loaded but before the Finder started.
  28.    My decision to release 1.1.3 was influenced by Kevin's thorough and
  29.    accurate diagnosis and by the fact that the fix was simple.
  30.  
  31. Q: Where can I obtain a copy of the final version of PwrSwitcher?
  32. A: I uploaded the final release to America Online.  I have heard
  33.    from correspondents that PwrSwitcher has been reposted to some
  34.    Internet archive sites that carry Macintosh software.  I do
  35.    not respond to requests to send disks.
  36.  
  37. Q: Why do you no longer support PwrSwitcher?
  38. A: I first released PwrSwitcher as a freeware program in July,
  39.    1991.  I have maintained PwrSwitcher and answered user
  40.    inquiries for two and a half years, now.  Newer models of
  41.    Apple computers don't have power keys that are capable of
  42.    triggering PwrSwitcher, so its usefulness is dimishing with
  43.    time.  Also, there are now several commercial and shareware 
  44.    products that provide capabilities similar to PwrSwitcher.
  45.    
  46. Q: Is it likely that PwrSwitcher will stop working?
  47. A: It is quite possible that a future release of Apple software
  48.    or hardware could impair the function of PwrSwitcher.  We've
  49.    already seen this with the special power keys found on Duos,
  50.    Color Classics, and other new machines.  I've also had to make
  51.    the PwrSwitcher code handle System 7.0 differently from 7.1,
  52.    since the code relies on an undocumented global that has moved
  53.    between system software releases.
  54.    
  55. Q: The power key on my Mac doesn't trigger PwrSwitcher.  Why?
  56. A: Many new Macs handle the power key using special hardware, rather
  57.    than treating it as just another key on the keyboard as with the
  58.    original ADB keyboards.  The Duos and all of the newer Macs that
  59.    allow you to shut down using the power key can't use the power key
  60.    to trigger PwrSwitcher.  If you refer to the PwrSwitcher
  61.    instructions, you'll see how to use the esc key (or control-esc)
  62.    instead of the power key. [Note: I've been told that there may in
  63.    fact be a keycode associated with the power key on some PowerBooks
  64.    or Duos.  I'll add this info to the FAQ as soon as I have more
  65.    details.]
  66.    
  67. Q: I'm running a PowerBook, so I have to set PwrSwitcher to use the
  68.    esc key.  But when I do a force quit (Command-Option-esc),
  69.    PwrSwitcher cycles to the next application, and then the system
  70.    asks me if I want to force that application to quit.  How do I fix
  71.    this?
  72. A: Set PwrSwitcher to require the control key by turning on that check
  73.    box in the PwrSwitcher control panel.  This way it won't intercept
  74.    the Command-Option-esc chord at all.
  75.  
  76. Q: What can I do to keep PwrSwitcher from conflicting with the
  77.    RadiusWare Cursor Beacon?
  78. A: Try checking PwrSwitcher's ``require control key'' option, and
  79.    activate PwrSwitcher with control-power.  This will leave the
  80.    power key (without the control modifier) to activate the 
  81.    cursor beacon.
  82.    
  83. Q: Why isn't PwrSwitcher's startup icon displayed in color?
  84. A: This is _the_ most often asked question, believe it or not.
  85.    PwrSwitcher uses its own icon drawing routines, rather than
  86.    Paul Mercer's ShowINIT.  I never considered the time spent on
  87.    changing this to be worthwhile - I don't watch the icons march
  88.    across the screen as my Mac starts up...
  89.  
  90. Q: I think I found a bug in PwrSwitcher.  What can I do?
  91. A: If you really want to keep using PwrSwitcher despite the bug,
  92.    your best course of action is to isolate the condition under
  93.    which the bug appears, then avoid that condition.  If you're
  94.    lucky enough to be able to isolate a conflict with one other
  95.    system extension or operating mode, then you have a choice...
  96.    
  97. Q: What PwrSwitcher replacements exist?
  98. A: Here are all the extensions that I've seen listed in the same
  99.    category as PwrSwitcher in various Mac books, or have discovered
  100.    through other sources:
  101.    
  102.      Apollo by Jeremy Roussak (shareware)
  103.      ProSwitch by Marcus Fest (postcardware)
  104.      ApplWindows by Hiroaki Yamamoto (freeware)
  105.      Just Click FKey by Luis A. Bardi (freeware)
  106.      QuicKeys by CE Software (commercial)
  107.      Switch by Jeff Bock (freeware)
  108.      GOTO FKEY by Matt Mora (freeware)
  109.      
  110.    I've used Apollo, ProSwitch, ApplWindows, and GOTO FKEY - all
  111.    of these have worked well for me.  I haven't used Switch
  112.    since before I started work on PwrSwitcher - its only fault
  113.    was that it couldn't work with background-only applications
  114.    running.
  115.    
  116. Q: Why does PwrSwitcher get stuck on some applications?
  117. A: I was never able to reproduce this on my machine.  One possibility
  118.    is that PwrSwitcher's stack check fails due to some application or
  119.    extension leaving a very small reserve stack space; I'm not fully
  120.    convinced that this is likely, though - the final version of
  121.    PwrSwitcher reduced stack requirements to a few hundred bytes, and
  122.    some people still see this problem.  Another possibility is that
  123.    the application patches _KeyTrans and somehow conflicts with
  124.    PwrSwitcher.  The source is available if anyone cares to
  125.    investigate further...
  126.  
  127. Q: Can I get source code for PwrSwitcher?
  128. A: Yes.  PwrSwitcher source is being posted to America Online
  129.    at the same time as this FAQ, and should appear on other
  130.    services and Internet archives as users cross-post the source.
  131.    Please do not ask me to mail you the source code or post it
  132.    to another service.
  133.  
  134. Q: What can I do with the PwrSwitcher source code?
  135. A: Two things - modify PwrSwitcher for your own use, or create
  136.    a new product based upon the PwrSwitcher source.  There is a
  137.    modest licensing fee ($0 for freeware products, $10 for 
  138.    shareware products, and $100 for commercial products) 
  139.    associated with the latter use of the code.  You may not, 
  140.    however, distribute a modified version bearing the PwrSwitcher
  141.    name or using PwrSwitcher’s registered signature.  Contact me
  142.    via email for further details.
  143.    
  144. Q: I noticed that PwrSwitcher is written in THINK Pascal.
  145.    Does THINK Pascal's demise have anything to do with dropping
  146.    support for PwrSwitcher?
  147. A: Although THINK Pascal has not seen a major upgrade since 1991,
  148.    it continues to perform admirably and remains, in my opinion,
  149.    the foremost example of good interface design for a program
  150.    development environment.  I removed THINK Pascal from my hard
  151.    disk immediately after the PwrSwitcher 1.1.2 release solely
  152.    to force me to concentrate on developing my proficiency with
  153.    other tools used in my day job.
  154.    
  155.  
  156.  
  157. Release History
  158. ===============
  159. The following information is available in the documentation which
  160. accompanies PwrSwitcher.  In case you'd like a quick reference to see
  161. what has changed since an earlier version you may have, the change
  162. history is repeated here:
  163.  
  164. 1.0a1 — First public release.
  165. 1.0a2 — Added backwards cycle function. Ignored Control key to aid
  166.         compatibility with RadiusWare Cursor Beacon.
  167. 1.0a3 — Added mark/swap functions. Added Finder help balloon.
  168. 1.0a4 — Added code to skip hidden layers. This version is designed not
  169.         to load under System 7.1 or later (as a fail–safe for the
  170.         hidden application detection code).
  171. 1.0a5 — Added color Finder icons. No longer confused as to the of
  172.         multiple copies of the same program. Changed the fail–safe
  173.         mechanism so PwrSwitcher can continue to load under System 7.1
  174.         and later (although hidden application detection may not
  175.         continue to work).
  176. 1.0b1 — Changed from extension to control panel. Added support for
  177.         Macintosh Portable using ‘esc’ key as substitute for Power
  178.         key. Rewrote documentation.
  179. 1.0b2 — Control panel now has preference controls and help balloons.
  180.         Must use Control key with all key combinations. Known to fix
  181.         “switch out problem” with Adobe Illustrator 3.0 (probably also
  182.         fixes less severe problem with Microsoft Excel 3.0).
  183. 1.0 — [November 1991] Removed MacsBug names to save space. Bundled
  184.         “NC” variant which doesn’t require use of Control key.
  185. 1.1b0 — [Not generally released] Found a better fix for the
  186.         Illustrator and Excel glitches, without need for the Control
  187.         key hack. Added a checkbox for those who actually got to like
  188.         adding the Control key to the activation chords — this also
  189.         means there’s no longer a separate ‘NC’ version. Added another
  190.         checkbox to specify choice of power key or ‘esc’ key, rather
  191.         than trying to decide based on keyboard Gestalt information.
  192.         Fixed a crash that would occur if you pressed the power key
  193.         after PwrSwitcher had loaded, but before the Finder had
  194.         started.
  195. 1.1b1 — [Not generally released] Made many cosmetic changes to the
  196.         control panel. Changed to use undocumented _LayerDispatch
  197.         interface rather than walking the data structures I
  198.         reverse-engineered in System 7.0 (since these changed in 7.1).
  199.         Fixed a crash that happened if you opened and closed
  200.         PwrSwitcher after booting with extensions disabled. Removed
  201.         the “notify if can’t switch” feature. Added a “re-hide”
  202.         feature.
  203. 1.1b2 [Never released] — Removed the _LayerDispatch calls and masked
  204.         over the controls that rely on this. Until I figure out the
  205.         appropriate selectors for _LayerDispatch, the “Auto-show
  206.         hidden applications” and “Re-hide hidden apps on switch out”
  207.         features will not be functional.
  208. 1.1b3 — [Not generally released] Restored the _LayerDispatch interface
  209.         using new information. Suppressed activation when a modal
  210.         dialog is the front window. Rearranged some internal code to
  211.         improve reliability. Internally disabled the re-hide feature,
  212.         and added some visual cues to indicate this non-feature. Fixed
  213.         the problem where the ‘esc’ key (when selected as the
  214.         activation key) was passed to the application during
  215.         switching.
  216. 1.1b4 — [First public beta] Removed the non-functional re-hide
  217.         control, and removed references from the documentation (except
  218.         in this section).
  219. 1.1b5 — Found that the _LayerDispatch code in 1.1b4 had some rare but
  220.         nasty side effects (layer mangling), so I tore it all out and
  221.         went back to the visibility-test code I used in PwrSwitcher
  222.         1.0, with appropriate changes to handle both System 7.0 and
  223.         System 7.1. With this change, I was able to get rid of all the
  224.         compatibility warnings — you don’t have to worry about the
  225.         “safety mode” documented with the 1.1b4 release.
  226. 1.1b6 — Added a screen saver check. Modal dialog check now ignores
  227.         invisible windows. Added a _DebugStr call, accessible via
  228.         shift-command-option-esc. Added a stack space check;
  229.         PwrSwitcher won’t try to do anything if it gets called when
  230.         _StackSpace returns less than 2K free. Changed the “GLOB”
  231.         template to encourage ResEdit customization.
  232. 1.1b7 — Made the modal dialog check more reliable. False positives
  233.         (causing PwrSwitcher to “stick” on certain applications)
  234.         should be a thing of the past.
  235. 1.1 — Ignore state of “require controls” checkbox for debugger chord.
  236.         Cut free stack check to 1K.
  237. 1.1.1 — Cut free stack check to 256 bytes. Add special case
  238.         recognition for Jasik’s Debugger, which doesn’t have a world
  239.         pointer. Recognize that debugger flags are always at $BFF on
  240.         machines with universal ROMs. Ignore presence of debugger in
  241.         32-bit mode when using Apple’s 32-bit System Enabler, due to
  242.         broken implementation of _Debugger and _DebugStr.
  243. 1.1.2 — Added a special check to enable the debugger chord in the
  244.         presence of Alain Birtz’s ABZmon debugger. ABZmon doesn’t
  245.         register itself by putting its entry address in the MacJmp
  246.         global. ABZmon defines OS trap $AAFF as its _DebugNum trap;
  247.         PwrSwitcher uses the presence of this trap as the indicator of
  248.         ABZmon’s presence.  [This is the last version.  I won't be
  249.         updating PwrSwitcher.]
  250.  
  251.  
  252. Acknowledgments
  253. ===============
  254. I would like to express my appreciation to the following authors
  255. and publishers who have included PwrSwitcher in a book or CD-ROM:
  256.  
  257.    Deke McClelland, ``Macintosh System 7: Everything You Need
  258.      To Know'' (Sybex 1992)
  259.    Bob LeVitus & Glenn Brown, ``Customizing Your Mac'' (Brady 1993)
  260.    David Pogue, ``MacWorld Macintosh Secrets'' (IDG Books 1993)
  261.    Arizona Mac User’s Group, ``BBS In A Box IX'' (AMUG 1993)
  262.    Clay Andres, ``The Little Mac Toolkit'' (Peachpit Press 1994)
  263.